Apple II Extended 80-Column jfc- 

Text Card Supple ment ; 



For lie Only 



Copyright 

© Copyright 1982, 1985. Apple Computer. Inc. lor 
all nontextual material, graphics, figures, 
photographs, and all computer program listings 
or code in any form, including object and source 
code. All rights reserved. 

For some products, a multi-use license may be 
purchased to allow the software to be used on 
more than one computer owned by the 
purchaser, including a shared-disk system. 
(Contact your authorized Apple dealer for 
information on multi-use licenses.) 

Apple and the Apple logo are trademarks of 
Apple Computer, Inc. 

Printed in Singapore. 



Limited Warranty on Media 
and Replacement 

If you discover physical defects in the manuals 
distributed with an Apple product or in the media 
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with proof of purchase to Apple or an authorized 
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IN NO EVENT WILL APPLE BE LIABLE FOR 
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR 
CONSEQUENTIAL DAMAGES RESULTING 
FROM ANY DEFECT IN THE SOFTWARE OR ITS 
DOCUMENTATION, even if advised of the 
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Warning 

This equipment has been certified to comply with 
the limits for a Class B computing device, 
pursuant to Subpart J of Part 15 of FCC Rules. 
Only peripherals (computer input/output devices, 
terminals, printers, etc.) certified to comply with 
the Class B limits may be attached to this 
computer. Operation with non-certitled 
peripherals is likely to result in Interference to 
radio and TV reception. 
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Radio and Television Interference 



The equipment described in this manual generates and uses radio- 
frequency energy. If it is not installed and used properly, that is, in 
strict accordance with our instructions, it may cause interference 
with radio and television reception. 

This equipment has been tested and complies with the limits for a 
Class 8 computing device in accordance with the specifications in 
Subpart J. Part 15. of FCC rules. These rules are designed to 
provide reasonable protection against such interference in a 
residential installation. However, there is no guarantee that the 
interference will not occur in a particular installation, especially if 
you use a "rabbit ear" television antenna, (A "rabbit ear" antenna is 
the telescoping-rod type usually contained on TV receivers ) 

You can determine whether your computer is causing interference 
by turning It off. If the interference stops, it was probably caused 
by the computer or its penpheral devices. To further isolate the 
problem: 

• Disconnect the peripheral devices and their input/output cables 
one at a time. If the interference stops, it is caused by either 
the peripheral device or its I/O cable. These devices usually 
require shielded I/O cables. For Apple peripheral devices, you 
can obtain the proper shielded cable from your dealer. For non- 
Apple peripheral devices, contact the manufacturer or dealer 
lor assistance. 

If your computer does cause interference to radio or television 
reception, you can try to correct the interference by using one or 
more ot the following measures; 

• Turn the TV or radio antenna until the interference stops. 

• Move the computer to one side or the other of the TV or radio. 

• Move the computer farther away from the TV or radio. 

• Plug the computer into an outlet that is on a different circuit 
than the TV or radio. (That is. make certain the computer and 
the radio or television set are on circuits controlled by different 
circuit breakers or fuses.) 

• Consider installing a rooftop television antenna with coaxial 
cable lead-in between the antenna and TV. 
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If necessary, you should consul! your dealer or an experienced 
radio/television technician (or additional suggestions. You may find 
helpful the following booklet, prepared by the Federal 
Communications Commission: 

"How to Identify and Resolve Radio-TV Interference Problems" 

This booklet is available from the U.S. Government Printing Office. 
Washington, DC 20402. stock number 004-000-00345-4. 



Radio and Television Interference 
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Who Needs To Read This 
Supplement? 



This supplement comes with the Apple lie Extended 80-Column 
Text Cafd and describes the added features it has. compared to 
the 80-Column Text Card Before reading this supplement, you 
should read the Apple lie 80-Column Text Card Manual. 

There are two ways you are likely to use the extended version of 
the 80-Column Text Card; 

• As a user with application programs that take advantage ot the 
extra memory on the card to give you more features or more 
storage for your data. 

• As a developer creating a program, for yourself or for others, 
that will use the extra storage the extended card provides. 

Users: A Card Is a Card 

From the user's point of view, the Extended 80-Column Text Card 
Is just like the standard 80-Column Text Card. Oh. it's a little 
bigger, and it costs more, but the technical differences between 
the two kinds of text cards are mostly hidden by software. Read 
Chapter 1 of this supplement for an introduction to the Apple lie 

80-Column Extended Text Card. 

The extended text card is installed the same way as the standard 
80-column card: read the Apple lie 80-Column Text Card Manual 
for directions. 



Preface 



vii 



Most application programs run the same with either card— in fact, 
many of them don't even take advantage of the extra memory on 
the extended card: they simply use it to display 80 columns of 
text. Programs that do use the extra memory may do so 
automatically, without any action on your part, or they may let you 
select optional features or data storage. To find out how to use 
those programs with the extra memory, refer to their instruction 
manuals. 

In short, if you just want to use this card for displaying 80 columns 
of text, and you aren't developing a program that uses the auxiliary 
memory, all you really need to know can be found in the Apple lie 
80-Column Text Card Manual and in the instructions for your 
application programs. 

Developers: How To Use the Auxiliary 
Memory 

The only difference between the Extended 80-Column Text Card 
and the standard 80-Column Text Card is the amount of memory 
they contain. The extended card has 64K bytes of auxiliary 
memory, while the standard card has only the additional 1 K bytes 
necessary to display 80 columns of text on an Apple lie. 

The main purpose of this supplement is to provide you with enough 
information to use the auxiliary memory in your programs. Normally, 
programs used with the Apple He can only work with the 64K bytes 
of built-in main memory To work with the auxiliary memory, a 
program must set special switches In the Apple lie that substitute 
auxiliary memory for main memory. Neither DOS 3.3 nor Pascal 
1 .1— system programs for the Apple II— support this memory 
substitution, so for now your application programs have to handle it 
themselves. 

Contents of This Supplement 

This supplement contains the information you need to use the 
auxiliary memory for storing programs and data. Chapter 1 is a 
general introduction; it describes the functions of the Extended 
80-Column Text Card. 

Chapter 2 is a general description of the design of the Extended 
80-Column Text Card; it explains how the card works with the 
Apple lie hardware. 
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Chapter 3 conlains directions (or using the auxiliary memory with 
your programs. Most ot the information in Chapter 3 is adapted 
from the Apple He Reference Manual The reference manual is your 
man source of information about the internal operation of the 
Apple lie. 

Chapter 4 contains short programs that use the auxiliary memory. 
These examples are functional, but not general: you will probably 
want to modify them for use in the programs you write. 



Symbols Used in This Supplement 

Special text in this manual is set off in different ways, as shown in 
these examples. 



Warning 

Important warnings appear in boxes like this. 



Reminder: Information that is only incidental to the text appears in gray 
boxes like this You may want to skip over such boxes and return to 
them later 



Captions, definitions, and other short 
items appear m marginal glosses like 
this 



Preface 



Extended Text Card Supplement 



Chapter 1 



Introduction 



3 Installation 

4 80-Column Features 

4 About the Auxiliary Memory 



Introduction 



1 



Chapter 1 



Introduction 



The design of !he Apple lie Extended 80-Column Tex! Card is the 
same as that of the standard Apple He 80-Column Text Card. The 
only difference is that the extended text card contains 64K bytes 
of auxiliary memory (programmable memory or RAM} while the 
standard card contains only IK byte of RAM. The 80-column 
display requires only 1K byte of auxiliary memory, so it will work 
with either card. The firmware that supports the special features 
associated with the 80-column display is part of the Apple lie itself, 
and works the same regardless of which card is present. 

Installation 

Installing the Extended 80-Column Text Card is easy do it just the 
way you install the standard 80-Column Text Card. Either card fits 
into the auxiliary slot (labeled aux. connector) on the main logic 
board inside the Apple He. If you haven't installed the card yet, 
follow the directions given in the Apple lie 80-Column Text Card 
Manual. 



Warning 

Never install or remove anything Inside the Apple He with the power on 
There is a small red lamp— an LED— toward Ihe back ot the main circuit 
board to remind you of this; if the red lamp is on, turn off the power 
before you do anything inside the Apple lie. 
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80-Column Features 



The built-in firmware thai supports the 80-column display has other 
features in addition to the wider display. The Apple He 80-Column 
Text Card Manual tells you how to activate the built-in firmware and 
the 80-column display. That manual also describes many of the 
Apple lie s features. 

You can find more information about the Apple lie in the Apple He 
Reference Manual, Chapter 2 includes a description of the different 
display modes and how to select them. Chapter 3 includes tables 
of the functions of the escape sequences and control keys in the 
Apple lie. 

About the Auxiliary Memory 

The Extended 80-Column Text Card has 64K bytes of additional 
RAM, usually referred to as auxiliary memory, A IK-byte area of 
this memory serves the same purpose as the memory on the 
80*Column Text Card: expanding the text display to 80 columns. 
The other 63K bytes can be used for auxiliary program and data 
storage. It you use only 40 columns for text display, all 64K bytes 
are available for programs and data. 

The processor in the Apple lie can only address 64K bytes of 
memory. The computer has special circuits that programs can 
switch to access auxiliary memory in place of main memory. At any 
one time, locations in the same 64K address space are in either 
main memory or auxiliary memory. In other words, even though an 
Apple lie with an Extended 80-Column Text Card has a total of 
128K bytes of programmable memory, it Is not appropriate to call it 
an 128K-byte system. Rather, there are 64K bytes of auxiliary 
memory that can be swapped for main memory under program 
control. 



Warning 

Careless switching to the auxiliary memory is almost certain lo crash 
your programs. If you want to use auxiliary memory in your own 
programs, be sure to study the rest of this supplement and the relevant 
information in the Apple He Reference Manual 
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Chapter 2 



How the Auxiliary Memory 
Works 



This chapter briefly outlines how the auxiliary memory operates. II 
will help you understand what happens when you use the auxiliary 
memory in your programs. 




Addressing the Auxiliary Memory 



The 6502 microprocessor can address 64K byles of memory. In 
the Apple lie the microprocessor's entire 64K memory space Is 
taken up by main RAM (random-access memory), ROM (read-only 
memory), and 10 (input- output); there's no memory space available 
for the added memory on the extended text card. Instead, the 
address bus is connected to the auxiliary memory in parallel with 
the main memory. To use the auxiliary memory lor program and 
data storage, the Apple He switches its data bus so that it reads 
and writes to the memory on the card instead of the main memory. 
To use the auxiliary memory to expand the display, the Apple lie 
fetches data both from main memory and from auxiliary memory, as 
described in the section How the 80-Column Display Works ^ 

The bus switching for program and data storage is controlled by 
the Memory Management Unit (MMU). a custom integrated circuit 
designed for the Apple He (see Chapter 7 ol the Apple lie 
Reference Manual). The MMU contains the soft switches set by 
your programs along with the logic circuitry to monitor the address 
bus and to switch to auxiliary memory for the selected address 
ranges. 
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Figure 2*1. Memory Map with Auxiliary 
Memory 
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As you can see by studying the memory map in Figure 2*1 , (he 
auxiliary memory is divided into two large sections and one small 
one. The largest section is substituted for main memory addresses 
512 to A91 51 (»2 00 through $bp ff). This part of memory is 
sometimes referred to as the 48K memory space, and it is used for 
storing programs and data. 

The other large section of auxiliary memory replaces main memory 
addresses 52k to 64K (soOOO through *ffff). This memory space 
is called the bank-switched memory. If you plan to use this part of 
the auxiliary memory, read the section "Bank-switched Memory' 1 in 
the Apple Ue Reference Manual. The switching for the ROM and 
the $0000 bank is independent of the auxiliary-RAM switching, so 
the bank switches have the same effect on the auxiliary RAM that 
they do on the main RAM- 

When you switch to the auxiliary memory in the bank*switched 
memory space, you also get the first two pages of auxiliary 
memory, from to 51 1 ($0000 through $01 FF). This part of 
memory contains page zero, which is used for important data and 
base addresses, and page one. which is the 6502 stack- 



Warning 

Remember that addresses in page zero and the 6502 stack switch to 
auxiliary memory any time you switch Ihe Dank-switched memory to 
auxiliary memory. 



How the 80-Column Display Works 

Half of the data lor the 80-column display is stored in main memory 
in the normal text Page 1 , and the other half is stored in auxiliary 
memory on the extended text card. The display circuitry fetches 
bytes of data from these two memory areas simultaneously and 
displays them as two adjacent characters. 



Memory pages are 256 bytes long. Qui 
display pages are either 1024 bytes, 
eg . text Page t or 8192 bytes, e g 
high-resolution graphics Page t See 
Chapters 2 and 4 ot the Appte He 
ftat&f&nce Manoat 



The main memory and the auxiliary memory are connected to the 
address bus in parallel, so both are activated during the display 
cycle. The 40*column display uses every other clock cycle and 
fetches data only from main memory. The 80-column display uses 
the remaining clock cycles to process Ihe additional display data 
from auxiliary memory. 
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Figure 2-2, Fetching Data for the 
80-Column Display 
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The byte of display data from main memory goes to a buffer on the 
main logic board, and the display data from auxiliary memory goes 
to a buffer on the extended text card. When the 80-column display 
is on. the data bytes from these buffers are switched onto the 
video data bus on alternate clock cycles: first the byte from the 
auxiliary memory, then the byte from the main memory. The main 
memory provides the characters displayed in the odd columns of 
trie display, and the auxiliary memory provides the characters in the 
even columns. 

The 80-column display contains twice as many characters as the 
40-column display does, so it has to put twice as many dots across 
the screen. This means that the dots are clocked out at 14MHz 
instead of 7MHz, making them narrower and therefore dimmer on a 
normal video monitor. On a television set, the dot patterns making 
up the characters are too close together to reproduce clearly. To 
produce a satisfactory 80-column display requires a monitor with a 
bandwidth of at least 14MHz 
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RG8 stands fen red. green, and Wue, 
and identifies a type of color monitor 
that uses independent inputs tor the 
throe primary cokre 



Excep) lor some expensive RGB-type color monitors, any video monitor 
with a bandwidth as high as 1 4MHz will be a monochrome monitor. 
Monochrome means one color: a monochrome video monitor can have 
a screen color of white, green, orange, or any other single color. 



Note that this stmultaneous-then-sequential (etching applies only to 
the video-display generation; reading and writing (or data storage In 
auxiliary memory is done by switching the data bus to read only 
from the card, as described in the previous section For more 
information about the way the Apple He handles its display memory, 
refer to Chapter 2 and Chapter 7 of the Apple He Reference 
Manuai 



When you select mixed-mode graphics with 80-column text, you 
would expect that the doubling of the data rate that produces the 
SOcolumn display would change the high -resolution graphics from 
280 to 560 dots horizontally and cause the low- resolution graphics 
to malfunction- To prevent this, the logic that controls the display 
includes an extra circuit to force the graphics displays to be the 
same regardless of whether you have set the soft switches for 
80-column text or for 40*column text. This feature is included so 
that you can use 80-column text in the mixed graphics and text 
modes. 

For those who would like to have a graphics display with twice the 
horizontal resolution, there is a way to disable the circuit that forces 
normal graphics timtng with 80-column text. There are two things 
you must do to obtain the double high-resolution display: 

• Install a jumper to connect the two Molex-type pins on the 
Extended 80-Column Text Card. 

• Turn on the Annunciator 3 soft switch along with the switches 
that select the 80-column display and high-resolution graphics. 

This procedure works only on the Apple lie with the Rev B (and 
later) main logic board, identified by a B as the last letter of the part 
number on the back part of the board. Connecting the pins on the 
Extended 80-Column Text Card completes a connection between 
pin 50 (AN3) and pin 55 (f rctxt ' ) on the auxiliary slot 
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Double High-Resolution Graphics 




Warning 

If you have a Rev A Apple He. using an extended text card with a 
jumper makes Ihe computer inoperable You cannol use the double 
high-resolution modification with a Rev A Apple He. 



If you have an extended text card with a jumper installed in a Rev B 
(or later) Apple He, turning on Annunciator 3 and selecting high- 
resolution graphics and 80-column text at the same time generates 
a display using high-resolution Page 1 addresses in main memory 
and auxiliary memory at the same time. 

The memory mapping tor this graphics display is doubled by 
columns the same way as 80-column text, but it uses high- 
resolution graphics Page 1 instead of text Page 1 . Where the 
80-column text mode displays pairs of data bytes as pairs ot 
characters, double high-resolution mode displays pairs of data 
bytes as 14 adjacent dots, seven from each byte. As in 80-column 
text mode, there are twice as many dots across the display screen, 
so the dots are only half as wide. 

Existing Apple II graphics programs do not support this kind of 
display. Until new programs become available, you'll have to write 
your own plotting routines if you want to use 560-dot graphics. 
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How To Use the Auxiliary 
Memory 



This chapter describes soli switches and built-in subroutines that 
control the operation of the auxiliary memory. To take advantage of 
the additional memory, you must set up your programs to operate 
in one part ol memory while Ihey switch the other part between 
main and auxiliary RAM. Your program can perform the memory 
switching by means of the soft switches described in the section 
"Display Mode Switching" or by using the auxhove and xfer 
subroutines described later in this chapter. Except for these 
subroutines, most existing Apple II system software (DOS 3.3, 
Pascal 1,1) doesn't support the auxiliary memory. 

Although some high-level languages, such as BASIC, can set the 
soft switches directly, your programs must use assembly -language 
subroutines to control the auxiliary memory. Small assembly- 
language subroutines can be accessed from a BASIC program 
using a call statement, or they can be linked to a Pascal program 
as procedures or functions: see the examples in Chapter 4. 



Warning 

Do nol attempt lo use the auxiliary memory directly from a program In 
an interpreter language such as BASIC or Pascal. The interpreters that 
run such programs use several areas In main memory, Including the 
stack and Ihe zero page. II you switch to auxiliary memory in these 
pages* Ihe interpreter crashes- When you reset the system lo slarl 
over, your program and data are lost. 
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The Extended Display 



Table 3-1, Video Drspiay Page 
Locations *Nott: These modes use 
locations in both main and auxiliary 
memory The PAG62 switch is used to 
select one or the other tor storing data 
see the section "Display Mode 
Switching" 



The primary purpose of an SOcolumn text card is the generation of 
an 80-column display, so there is a complete set of switches just 
to control the display. Other switches are used for program and 
data storage in the auxiliary memory; they are described later. 

Display Pages 

The Apple He generates its video displays from data stored in 
specific areas in memory called display pages. The 40-column-text 
and low-resolution-graphics modes use text Page 1 and text 
Page 2, located at 1024-2047 (hexadecimal *400-$7ff) and 
2048-3071 <S800-$BFF) in main memory. 

The 80-column text display uses a combination of text Page 1 in 
main memory and the same page in the auxiliary memory, here 
called Page IX. Text Page 1X occupies the same address space 
as text Page 1 , but in auxiliary memory rather than main memory. 
To store data in Page 1X t you must use a soft switch (see the 
section "Display Mode Switching*'). The built-in 80-column display 
routines described in Chapter 3 of the Apple He Reference Manual 
take care of this switching automatically; that is a good reason to 
use those routines for all your normal 80-column text output 
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For tnformalion about the keyboard data 
and strobe (unctions, see Cnapte* 2 o! 
IN) Apple lie Reference Manual 



Display Mode Switching 

You select the display mode that is appropriate (or your application 
by reading or writing lo soft switches. Most solt switches have 
three memory locations: one for turning the switch on. one lor 
turning it off. and one for reading the state of the switch. 

Table 3-2 shows the locations of the soft switches that control the 
display modes. The table gives the switch locations in three forms: 
hexadecimal, decimal, and negative decimal. You can use the 
hexadecimal values in your machine-language programs Use the 
decimal values in peek or poke commands in Applesoft BASIC; the 
negative values are for Inleger BASIC. 

Some of the soft switches in Table 3-2 are marked read or write. 
Those soft switches share their locations with the keyboard data 
and strobe functions. To perform the function shown in the table, 
use only the operation listed there. Soft switches that are not 
marked may be accessed by either a read or a write. When writing 
to a soft switch, it doesn't matter what value you write; the switch 
function occurs when you address the location, and the value is 
ignored. 



Warning 

Be sure to use only the indicated operations lo manipulate the 
switches. If you read from a swifch marked wnte. you won't get the 
correct data. It you write to a switch marked read, you won't set the 
switch you wanted, and you may change some other switch so as to 
cause your program to malfunction. 

When you read a soft switch, you get a byte with the state of the 
switch in bit 7. the high-order bit The other bits in the byte are 
unpredictable. If you are programming in machine language, this bit 
is the sign bit. If you read a soft-switch from a BASIC program, you 
get a value between o and 255. Bit 7 has a value of 1 28. so it the 
switch is on. the value will be equal to or greater than 1 28; if the 
switch is off. the value will be less than 128. 
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Table 3-2- Display Soil Switches (1| 
This mode is oo\y effective when text 
swtich ts off (2) This switch has a 
dtflorent 'unction when AOs tore is on 
reler to the next section (3) This switch 
changes the functon ot the PAGE2 
switch to* addressmg the display 
memory on the extended text card; 
refer to the next section 
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Read PAGE2 Switch 


SC05S 
SC054 

icon 


49237 
49236 
49180 


-16299 
-16300 
-16356 


2 

2 

Read 


HIRES 


On: Graphics = High- 
Resolution 

Ofl Graphics • Low- 
Resolution 

Read hires Switch 


SCOW 

SC0S6 
SC01D 


49239 

49238 
49181 


-16297 

-16298 
-16355 


1 

1 

Read 


SDCOL 


On Display 60 Columns 
Off Display 40 Columns 
Read BOCOL Swttch 


SCOOD 
SCOOC 


49165 
49164 
49183 


-16371 
-16372 
-16353 


Write 
Wrtte 
Read 


SOS TORE 


On Store In AuxIMa/y Page 
Off Store in Mam Page 
Read SOS TORE Switch 


ICOOt 

scooo 

SCOIfl 


49153 
49152 
49176 


-16383 
-16384 
-16360 


Wnie.3 
Write, 3 
Read 



Addressing the 80-Column Display Directly 

Figure 3-1 is the map of the 80-column display. Halt of the data is 
stored in text Page 1 in main memory, and the other halt is stored 
in the same locations In auxiliary memory (here called Page 1X). 
The display circuitry letches bytes from these two memory areas 
simultaneously and displays them sequentially; first the byte (rom 
the auxiliary memory, then the byte from the main memory. The 
main memory stores the characters in the odd columns ot the 
display, and the auxiliary memory stores the characters in the even 
columns. For a full description of the way the Apple He handles its 
display memory, refer to Chapter 2 and Chapter 7 of the Apple lie 
Reference Manual. 
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For a dosciiptoon ol the way the high- 
order bil acts as color-select bit in 

high-resolution displays, sec Chapters 2 
and 7 o( the Apple lie Reference 
Manual 



To store data directly into the display page on the Extended 
80-Column Text Card, first turn on the aostore soft switch by 
writing to location 49153 (negative decimal -1 6583 or hexadecimal 
SC001) With 80s tore on. the page-select switch PAGE2 switches 
between the portion of the 80-column display stored in Page 1 of 
main memory and the portion stored in Page 1X in auxiliary 
memory. To select Page IX, turn Ihe page 2 soft switch on by 
reading or writing at location 49237 (-16299. 1C055). 

You'll have to write a short program to try out the 80 STORE and 
PAGE 2 soft switches. When you try to change these switches by using 
the Monitor program, it changes them back in Ihe process ot displaying 
the commands you type. 

II you want to use the optional double-high-resolution display 
described in Chapter 2, you can store data directly into high- 
resolution graphics Page tX in auxiliary memory in a similar fashion. 
Turn on both sostore and hires, then use PAGE2 to switch from 
Page 1 in main memory to Page IX in auxiliary memory. 

The memory mapping for double high-resolution graphics is similar 
to the normal high-resolution mapping described in Chapter 2 of the 
Apple tie Reference Manual, with the addition of the column 
doubling produced by the 80-column display. Like the 80-column 
text mode, the double high- resolution graphics mode displays two 
bytes in the time normally required for one, but it uses high- 
resolution graphics Page 1 and Page 1 X instead of text Page 1 and 
Page IX. 

Double high-resolution graphics mode displays each pair of data 
bytes as 14 adjacent dots, seven from each byte. The high-order 
bit (color-select bit) of each byte is ignored. The auxiliary-memory 
byte is displayed first, so data from auxiliary memory appears m 
columns 0-6. 14-20, etc., up to columns 547-552. Data from main 
memory appears in columns 7-13, 21-27, and so on up to 
553-559. 

As in 80-column text, there are twice as many dots across the 
display screen, so the dots are only half as wide. On a TV set or 
low-bandwidth monitor, single dots will be dimmer than normal. 
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Figure 3*1, Map of 80-Column Te*t 
Dtsptey 
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When R*MWM and hahrd are on. 
auxrfiary momofy a used, when they are 
o«. main memory is used 



Auxiliary Memory Switching 

This section describes the switches used to access the auxiliary 
memory for storing programs and data. 



Warning 

The display soft switches 80S TORE. PAGE2. and HIRES, discussed 
here and in the previous section, are used primarily tor addressing 
display data. These swilcnes override the general-purpose switches 
described in this section, so you must set them correctly even it your 
program doesn't use them. 



Switching the 48K Bank 

Switching the 48K-byte section of memory is performed by two 
soft switches: ramrd selects main or auxiliary memory for reading, 
and rahuri selects main or auxiliary memory for writing. As shown 
in Table 3-3, each switch has a pair of memory locations dedicated 
to it, one to select mam memory, and the other to select auxiliary 
memory. Setting the read and write functions independently makes 
it possible for a program whose instructions are being fetched from 
one 48K-byte memory space to store data into the other 48K 
memory space. 



Warning 

Betore using these switches, you must fully understand the effects of 
switching to auxiliary memory. For example, an application program 
running in the 48K bank of auxiliary memory that tries to us© the built-in 
10 routines by calling the standard 10 links will crash even though the 
main ROM, which contains the built-in |;0 routines, has been selected 
This happens because the standard links call DOS routines, and DOS is 
tn the 48K bank of main memory, which is locked out while the 
application program is running in auxiliary memory. 

Writing to the soft-switch at location 1C003 turns rahro on and 
enables auxiliary memory for reading; writing to location SC002 
turns ramrd ott and enables main memory for reading. Writing to 
the soft-switch at location 1C005 turns rahwrt on and enables the 
auxiliary memory for writing; writing to location scooa turns ramurt 
off and enables main memory for writing. By setting these switches 
independently, you can use any of the four combinations of reading 
and writing in main or auxiliary memory. 
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Auxiliary memory corresponding to text Page 1 and high-resolution 
graphics Page 1 can be used as part o( the 48K bank by using 
ramrd and r amwrt. These areas in auxiliary memory can also be 
controlled separately by using the display-page switches 80s tore, 
page 2. and hires described in "Addressing the 80-Column 
Display Directly." 

As shown in Table 3-3. the 80s tore switch functions as an 
enabling switch: with it on, the PAGE2 switch selects main memory 
or auxiliary memory. With the hires switch oft, the PAGE2 switch 
selects main or auxiliary memory in the text display Page 1 , so 40 
to J07FF. with hires on. the page2 switch selects main or 
auxiliary memory in text Page 1 and high-resolution graphics 
Page 1, $2000 to S3FFF, 

If you are using both the 48K-bank control switches and the 
display-page control switches, the display-page control switches 
take priority; if bostore is off, ramrd and ramwrt work for the 
.entire memory space from S0200 to sbfff. but it sostore is on, 
ramrd and ramwrt have no effect on the display page 
Specilically. if 80STORE is on and hires is off. PAGE2 controls text 
Page 1 regardless ot the settings ot ramrd and rahurt. Likewise, 
if 80STORE and hires are both on, page2 controls both text 
Page 1 and high- resolution graphics Page 1. again regardless of 
ramrd and ramurt. 

You can find out the settings ot these soft switches by reading 
trom two other locations. The byte you read at location SC013 has 
its high bit (the sign bit) set to 1 it ramrd is on (auxiliary memory is 
enabled for reading), or o if ramrd is off (the 48K block of main 
memory is enabled for reading). The byte at location scoi 4 has its 
high bit set to 1 if ramwrt is on (auxiliary memory is enabled for 
writing), or if ramwrt is off (the 48K block of main memory is 
enabled for writing). 
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Figure 3-2- Effect o! Switching MKRO Main Auxiliary 

and RAMWRI with 80ST0RE Oil Memory Memory 
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Figure 3-3. EMect ol Switching rahad 
ind rahurt with aostore and hires 
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Switching High Memory, Stack, and Zero Page 



When li*e A i r Z P sod switch is on. 
auxiliary memory is used, when it is otf. 
main memory «s ust'O 



The single sott switch altzp (alternate zero page) switches the 
bank-switched memory and the associated stack and zero page 
area between main and auxiliary memory. As shown in Table 3-3, 
writing to location SC009 turns altzp on and selects auxiliary- 
memory stack and zero page; writing to Ihe sott switch at location 
SC008 turns altzp off and selects main-memory stack and zero 
page for reading and writing. The section 'Auxiliary- Memory 
Subroutines" describes firmware that you can call 1o help you 
switch between mam and auxiliary memory. 

To find out the setting of this soft switch, read location icoi 6. The 
data byte you get has its high bit (the sign bit| set to 1 if altzp is 
on (the bank-switched area, slack, and zero page in the auxiliary 
memory are selected), or o if altzp is oft (the same areas in main 
memory are selected). 

To have enough memory locations for all ot the soft switches and 
remain compatible with the Apple II and Apple II Plus, the sott switches 
listed in Table 3-3 share their memory locations with the keyboard 
tunctions listed in Chapter 2 of the Apple lie Reference Manual. 
Whichever operation— read or write— Is shown in Table 3-3 for 
controlling the auxiliary memory is the one that is not used for reading 
the keyboard and clearing the strobe 
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Table 3-3- Auxiliary- Memory Select 
Switches. (1) When 80S TORE «on, the 
PAGE? switch works as shown; when 
80STOHE is off. PAGE 2 doesn't aHect 
the auxiliary memory. (2) When 
AOS TORE & on. the HIRES switch 
enables you to use the page? switch to 
select between high-resoiution Page i 
areas in main and auxlkary memory 



Name 



Function 



Location 

Hex Decimal 



Notes 



R A M R D 


On: Read Aux. AQK 


SC003 


49155 


-16381 


Write 




Oil Road Mam -i.".k 


SC002 


49154 


-16382 


Wnte 




Read RAMRO Switch 


SC013 


49171 


-16365 


Read 


RAHWRT 


On Wnie Au* 48K 


I C005 


49157 


-16379 


Wnte 




OH: Whte Main 48K 


scoot 


49156 


-16380 


Write 




Read RAMWHT Switch 


JC014 


49172 


-16354 


Read 



ALTZP On; Aux Stack. Zero 
Page, and Bank- 
Switched Memory 

0« Ma*i Stack. Zero 
Page, and Bank 
Switched Memory 

Read aitzp Switch 



SC009 49161 -16373 Write 



SCOOS 49160 -16374 Wnto 
SC016 49174 -16352 Read 



SOSTORE 


On: Access Page IX 


1C001 


49153 


-16383 


Wnte 




Off: Use RANRD , R AMU B T 


SCOOO 


4915? 


-16384 


Write 




Road SOS TORE Switch 


SC018 


49176 


-16360 


Read 


PAGE? 


On: Access Auk. Memory 


SC055 


49237 


-16299 


1 




Off; Access Main Memory 


JCD54 


49236 


-16300 


1 




Read PA (IE? Switch 


SC01C 


491S0 


-16356 


Read 


HIRES 


On Access High- 












Re&olufwn Page IX 


IC057 


49239 


-16297 


2 




Off: Use RAHRD, RAMWRI 


SC056 


49238 


-16298 


2 




Read MIRES Switch 


SC01 D 


49181 


-16355 


Read 



Extended Text Card Supplement 



Figure 3-4, Effecl o) Switching ALTZP 
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Figure 3-5* Effect of Switching PAGE2 Main Auxiliary 

wilh 805TORE and HIR65 On Memory Memory 
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Auxiliary-Memory Subroutines 



If you want to write assembly-language programs or procedures 
that use auxiliary memory, the built-in auxiliary-memory subroutines 
will be helpful- These subroutines make it possible to use the 
auxiliary memory without having to manipulate the soft switches 
already described. 

The subroutines described in thts section make it easier to use auxiliary 
memory, bul they do not protect you from errors You still have to plan 
your use of auxiliary memory to avoid inexplicable crashes 

You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3 of the Apple lie Reference 
Manual: by making subroutine calls to their starting locations. Those 
locations are shown in Table 3*4. 

Table 3-4. Auxiliary-Memory Routines 

Subroutine 

Name Location Description 



auxhove SCS11 Moves data blocks between main and 

auxiliary memory 



XFE R SC314 Transients program control between 

main and aux-Jiary memory 



Moving Data To Auxiliary Memory 

In your assembly-language programs, you can use the built-in 
subroutine named auxhove to copy blocks ot data from main 
memory to auxiliary memory or trom auxiliary memory to main 
memory. Before calling this routine, you must put the dala 

The carry bit *a bit o m the processor addresses into byte pairs in page zero and set the carry bit to 
status word: use the sec instruction to select the direction of the move— main to auxiliary or auxiliary to 

main. 



set it. and etc to clear It 



Warning 

Don't try to use auxhove to copy data in page zero, page one (the 
6502 stack), or in the bank-switched memory ISDOOO-SFFFF). 
AUXHOVE uses page zero while it is copying, so it can t handle moves 
in the memory space switched by ALTZP, 
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Remember that Pascal uses page zero too. so you can't use 
AUXHOVE from a Pascal procedure without saving the contents of page 
zero first, and restoring them afterward. 



Tablt 3-5. Parameters to* auxmovE 
floutme 



The pairs of bytes you use for passing addresses to this subroutine 
are called A1 T az, and A4; they are used tor passing parameters to 
several of the Apple lie's built-in routines. The addresses of these 
byte pairs are shown in Table 3*5. 



Name Location Parameter Passed 



Carry 1 = Move from mam to auxiliary memory 

= Move from auwllary to main memoy 

A1 L 43C Source slarhng address, low-order byte 

A 1 H S30 Source slarhng address, high-order byle 

A2 L »3€ Source ending address, (ow-order by!© 

A2H S3f Source ending address, high-order byle 

JUL $42 Dest*iai>on siarting address low-order byte 

A4H Destination starling address, high-order byte 



Put the addresses of the first and last bytes of the block of 
memory you want to copy into A1 and A2. Put (he starting address 
of the block of memory you want to copy the data to into A4. 

The auxmove routine uses the carry bit to select the direction to 
copy the data. To copy data from main memory to auxiliary 
memory, set the carry bit (sec); to copy data from auxiliary memory 
to main memory, clear the carry bit (CLC). 

When you make the subroutine call to auxhove, the subroutine 
copies the block of data as specified by the a registers and the 
carry bit. When it is finished, the accumulator and the x and y 
registers are just as they were when you called it, 



Transferring Control To Auxiliary Memory 

You can use the built-in routine named xfer to transfer control to 
and from program segments in auxiliary memory. You must set up 
three parameters before using xfer: the address of the routine 
you are transferring to t the direction ot the transfer (main to 
auxiliary or auxiliary lo main), and which page zero and stack you 
want to use. 
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Table 3-6. Parameters lor XFER Routine 

Neme or 



Loc&tkjn Parameter Passed 

Carry 1 « Transfer from main to auxiliary memory 

= Transfer trorfl auxiliary to main memory 

Overflow 1 = Use page zero and stack m auxiliary memory 

» Use page zero and stack *i main memory 

Si ED Program starting address, low-order byle 

S3 EE Program starting address, high-order byte 



Put the transfer address into the two bytes at locations $3 ED and 
13 EE. with the low-order byte first as usual The direction of the 
transfer Is controlled by the carry bit: set the carry bit to transfer to 
a program in auxiliary memory, clear the carry bit to transfer to a 
program in main memory. Use the overflow bit to select which page 
zero and stack you want to use; clear the overflow bit to use the 
main memory; set the overflow bit to use the auxiliary memory. 



Warning 

it Is the programmer s responsibility to save the current stack pointer 
somewhere in Ihe current memory space before using Xf ER and to 
restore ft after regaining control. Failure to do so will cause program 

errors- 



After you have set up the parameters, pass control to the x f e r 
routine by a jump instruction, rather than a subroutine call, x f E R 
saves the accumulator and the transfer address on the current 
stack, then sets up the soft switches for the parameters you have 
selected and jumps to the new program. 



The ovefflow bit is btt 6 in the 

procossor status word: use the ClV 
instruction to clear it To set it. force an 
overflow by adding two numbers that 
total more than 127 
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Chapter 4 



Programming Examples 



This chapter contains examples showing how to use the auxiliary 
memory from a program. These examples are not intended to be 
universal routines that everyone can use as is; rather, they are 
representative examples showing how specific operations have 
been implemented You will probably want to study the examples to 
see how it is done, then copy or modify them to suit your 
application 



Identifying Different Configurations 

By identifying the configuration of the machine they are running on. 
application programs for the Apple He can take advantage of the 
new features and still remain compallble with older Apple ll's. This 
section gives a procedure for doing this from assembly language 
and shows how to use the identification routine in programs written 
In Applesoft BASIC and Pascal. 

The identification routine returns a value to the calling program that 
depends on the type of machine it is running on. Table 4-1 shows 
the return codes. 



Table 4-1. Identification Return 

Codos soo |0J - not an Apple lie 



S20 (32) - Apple lie. but no Apple lie 80-Column Text Card 

S40 (64) « Apple lie with 60'Column Te*t Catd without auxrflary memory 

S80 (1281 - Appie lie with Extended 80-Column Text Card 
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Note: An 80-column card installed in expansion slol 3 will work in an 
Apple He (he same as in an Apple II or Apple II Plus, but it does not 
activate the built-in 80-column firmware. The identification program does 
not detect such a card, but returns a code ol 32 no Apple lie 
80-Column Texi Card. 

Here Is an outline ol the procedure the Identification routine uses to 
Identify an Apple lie and its variations: 

1 . Save four identification bytes from the ROM RAM area ($0000 

tO $FFFF). 

2. Disable interrupts. 

3. Switch bank-switched memory to read ROM by reading $C089 
twice. 

4. Identify Apple He by finding the value 06 at $fbb3 

5. If Apple He, and high bit Is on at location $C0i7, then the 
computer has a text card. 

6. If Apple He with 80-Column Text Card, then check tor auxiliary 
memory: 

a. If SC013'S high bit is on. then reading auxiliary memory so 
musl have auxiliary memory. 

b. If U016S high bit Is on, then reading auxiliary zero page 
so must have auxiliary memory. 

c. It sparse memory mapping (no upper tour address bits so 
that S800 has the same RAM location as icoo). then no 
auxiliary memory. 

1 . Exchange a section of zero page with the section of 
code that switches memory banks. This way the zero 
page data is saved and the program doesn't get 
switched out. 

2. Jump to the relocated code on page zero. 

3. Switch In auxiliary memory ($200 - $8FFF) for reading 
and writing by writing to $C005 and $C003. 

Note: Auxiliary memory locations $400-$800 and 
$2000-$4000 may not be available depending upon 
the setting of soft switches tor 80-column display and 
high-resolution graphics— they have priority over 
auxiliary memory selection. 
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4. Store a value at ssoo. and see if same value at scOO 
If not, then auxiliary memory. 



5. Change value at $ coo, and see if $800 changes to 
same value If so. then no auxiliary memory. 

6. Set soft switches for reading and writing to main 
memory by writing to sc002 and scoot. 

7. Jump back into program on main RAM 

8. Put zero page back. 

7. Store identification byte for later reference by calling routine 

8. It Pascal routine then turn card back on by reading SCO88 
twice. 

9. The BASIC or assembly-language routines restore the 
RAM ROM area as it originally was by checking four bytes 
saved at the start of the routine. 

10. Enable interrupts. 

11. Return to caller. 

For some applications it may not be necessary to identify the exact 
configuration of the computer. For example, if your program cannot 
use the auxiliary memory, then you would not need to know 
whether it is available or not. In that case you may want to eliminate 
parts of the routine. For other applications the identification routine 
will use memory space required by your program, so you will need 
to move the routine to some other location. 



Warning 

If you change the identilicalion routine, make sure that it still determines 
the configuration tn the same way as the original. Later revisions ot the 
Apple He may not support other identification procedures 



Apple He Identification in Assembly Language 

The assembly-language subroutine given here is assembled to 
machine language in locations S2D0 through S3Cf. To call the 
subroutine, your program does a jump to subroutine (JSR) to $2D4 
When the subroutine returns, the identification code is stored in 
memory location S3CF- 
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Apple He Identitlcalion Program 
19B2 





QBG 






SAFE 


EOU 

m w H 


I3CF 




:, A v i 


EOU 


SOOQ1 


;5TART OF CODE RELOCATED OK PACE ZERO 




EflU 


S2M 


aSTIIT OF fOUft 8 TIE LANGUAGE CARD 1 D 




PHP 




;0]SA8lE INTERRUPTS 




511 








IDA 


SEQOO 


;SAVE k BYTES FRO* 




sta 


Mfl 


; ROMt AM AREA FOR LATER 




L DA 


IDOOO 


; R E 5 TOR I NG OF RANRO* 




5 T A 




: TO ORIGINAL CONDITION 




IDA 


tDCOO 






ST* 


SAVE 






IDA 


tDBOO 






ST* 


SAM 1+3 






LO* 


*C081 


;E*5yflE BEADING ROM IV TURNING OFF 




LDA 


SCQB1 


i uauitt w : " 




IDA 




; GET APPLE ll€ SIGNATURE BYTE 




CPfP 








are 


0UT1 


frIF ROT *6 THEN NOT APPLCI1E 




IDA 


IC017 


tUAS AO COtUHHS FOUND DURING STARTUP 




AMI 

¥t 1 


Out? 


; I F H T BIT ON THER NO SO COLUMN CARD 




(OA 


scon 


;^EC IF AUI MEMORY BEING READ 

mm —mw —mu —mw —m- mm mmu m'm m m mm— m w mm - m w m mm mmm —f nr ■ mm- m w mmi m mr 




ini 


QUT4 


:AU1 MEM BEING USED SO AUX MEN AVAIL. 

r m— t ■ mm - — mm - mr m m— mr — — . 




LOA 


% COl 6 


;SEE IF AUK 7P BEING USED 

m" — i- mr- mmu mm - r w mmr - h r tt ■ i— ■ -^v — t 




1HI 

w • 


0UT4 


:AU' BEING USED SO AUX MEM AVAIL 

■ v r ■ ■ i mm - —mu mmr mmr mmr mmm mmr mmr mmr — mmr r "w v ■ r r m - m 1 r v v 






r DONE - ^TlRT 


*RD T SuM E t£T (0 KEEP CRICKING 


HV 


L 01 

V V 1 


START-1 , V 


:SUAP SECTION OF ZP tflTH 

r mr mu — r m mmr mmr mmr r mmr mmr rmr mm - mmm mmm mm - m m;m 




t OA 

h —^ 


SAFE * 1 _ ¥ 


;C00E HEEDING SAFE LOCATION DURING 

mr mm - mmr mmr mmr —mr mmm- mmr mm - mmr rum mmr mmm u m m mmr mmu mmr mm- mi i mr mmr rmr mr mmu r mu — — mmr 






S Af F~ T . ¥ 


* Rf AO AUI "F * 




ST A 


5TART-1 f V 






OtT 








BMF 


by 






J HP 


SAFE 


:JUNP TO SAFE GROUND 

r mmr mmr r m - m 1 mmr mmr u m r mmr mmu u mmu mmr u m mm- 


ON 


PhP 




'BACK FRO* SAFE GROUND. SAVE STATUS 




LD Y 


HE- STAR! 


:M0VE ZERO PAGE BACK 

mu — r uur m mmr mmr mmr r m mmr r r mm mmr - mm mr m r 




L OA 


START-1 ,Y 






ST A 


SAFE -1 . Y 






OET 








BRE 








▻ la 




; GE T BACK STATUS 

mu "w ¥¥ m - • — r mr - ■ i™ —r —- 




BC5 


DUT3 


;CAIRt SET SO HO AUX MEN 


OUT 4 


IDA 


• w » 


*UA0E 1 T $0 there IS Ay» NIK set 




S T A 


PA HAW 


; PAW AW- 190 

mm m m mm mrm mrmr mmr mmm mm 




jhp 


OUT 




ours 


LDA 


>f iO 


;B0 COLUMNS BUT NO AUX SO SET 

■ mmm mmr mm mmr mmm mmm m m mmu mmu mmm mmm mmu —r m mm— mmm mmu mmm mmu 




5 T A 


P# H A* 


I P ARAM fc t AO 




JNP 


OUT 




OUT? 


LDA 




j APPLE HE BUT NO CARD SO SET 




ST A 


PARA* 


;PARAM-f20 




J*P 


Out 




OUTt 


LDA 


*0 


;R0T AN APPLE I1C SO SET PARAN-0 




5 T A 


PA >t AM 
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OUT LDA SEOOO fll ALL * BYTES THE SAME 

CUP SAVE ;TMf LANGUAGE CARD NEVER 

BNE OUTON ;WA5 ON 50 00 NOTHING 

LDA tOOOO 

CMP 3AVEO 

BN€ OUTON 

LOA SD400 

CUP 3AVE*2 

DNf OUTON 

LOA soaoo 

CMP 5AVI»3 

BEG GOOUT 

outon loa itoaa ;no match, SO turn f j *s t 

LDA $6000 ;«ANK Of Lt OH AMD CHECK 

CMP SAVE 

BE3 OUTONO 

LDA SCOBO 

JMP GOOUT 

OUTONO LDA SDQOO 

CMP 5AVE+1 j t F ALL LOCATIONS CHECK 

8E0 0UT0N1 ;THEM 00 NOTHING MORE 

LOA tC060 ; OT WE Rw ( S E !y«M ON BANK Z 

JMP GOOUT 

OUTONt LDA (D40G |CHECK SECOND BYTE IN SANK \ 

CMP SAVE-*-? 

IEO OUTON* 

LOA IC080 SELECT RANK 2 

J MP GOOUT 

0UT0U2 LDA 10BOO :CHECK THIRD 1*11 IN 9AM 1 

CMP 5AVE-J 

EES GOOUT 

LDA 1C0H0 ; SELECT RANK 2 

GOOUT PLP ; A E 5 E T INTERRUPTS 
RTS 

ROUTINE RUN IN SAfE AREA NOT AFFECTED BY MOVES 

START LDA ;TRT STORING IN AUK MEM 

ST A 1C005 ;VRITE TO AUK *4« I LE ON MAIN IP 

ST A 1C003 MET TO READ AUK RAM 

ST A 1B00 fCHICK fOR SPARSE MEM MAPPING 

LOA SCOO ;$EE If SPARSE MEMORY -SAME VALUE 

CMP *«€ ; IK AWAY 

EVE AUXHEM 

AS L BCOO ;MAY BE SPARSE MEM SO CHANGE VALUE 

LDA SSGO ; A SEE WHAT HAPPENS 

CMP ICOO 

ine auxmeh 

sec ;sparse mapping so no aui mem 

b:s back 

AUKMEM CLC jThERE IS Au* MEM 

BACK STA ICOOt jSVITC* BACK TO MRITE MAIN RAM 

STA ICOO? ;SW!TC* BACK MAIN RAM READ 

JMP OM ; CONTINUE PROGRAM ON PG 3 MAIN RAM 

DONE MOP : END OF RELOCATED PROGRAM MARKER 
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Apple He Identification from BASIC 



One way to identity the configuration of an Apple lie from BASIC is 
to load (using bloao) the machine-code version of the assembly- 
language routine described in the previous section, then execute a 
call statement to location 724 ($2D4). When the subroutine 
returns to the BASIC program, executing a peek at location 975 
($3Cfl gets the result. 

Here is another approach to writing a BASIC program to identify the 
type ot Apple II it is running on. In this program the assembled 
code lor the assembly-language identification routine from the last 
section is included in the data statements. 

Apple lie identification from 

Applesoft BASIC 1DM1AB. 120, \n $ 0, 224, U1 1 208, 2, 173, 0, 208. 141, 209, 2, 173. 0. 

212, Ut r 210, 2, 173, 0, 214, U1, 211, 2, 173, 129, 192, 173, 129, 

192, 173, 179, 251 , 201 , 6, 206, 73* 173 
20 DATA 23, 192, 46. 60, 173, 17. 192, 46, 39, 1 73, 22, 192, 46, 3*, 160, 42, 

190, 162, 3, IBS, 0, 0, 150, 0, 1 53, 162, 3. 136, 20$, 2*2, 7*, 1 ( 0, 

B, I6D, 42, HV 162, 3, 133 
30 DAT* A, 0, 136. 206, 247, ID4, 176, E, 169, 128, 141, 2 07. 3 p 76, 73, 3, 

169, 64, 141 , 207, 3, 7«, 73, 3, 169, 3 2 , 1 41 , 207 , 3 t 76< 73, 3, 169, 

0, 141 , 207, 3, 173, 0, 224 
40 DATA J05, 206, t t 208, 24, 173, 0, 205, 205, 209, 2. 208, 16, 173, 0, 212, 

205, 210, 2, 208, 6, 173. 0, 216, 205, 211, 2, 240, 56, 173, 136, 192, 

173, 0, 224, 205, 208, 2. 240, 6 
50 0AM 173, 128, 192. 76, 161, 3, 173, 0, 209, 205, 209, 2 T 240, 6, 173, 128. 

192, 76, 161, 3, 173, 0, 212, 205, 210, 2, 240, 6, 173, 128, 192, 76. 

161, 3, 173, 0, 216, 205, 21 1, 2 
60 OA'A 240, 3, 173, 128, 192, 40. 96, 169, 238, 141 , 5, 192, 141, 3, 192, 

141, 0, B, 173, 0. 12, 201, 236. 208, 14, H» 0, 12. 173, 0, &. 203, 0, 

1 2, 208, 3, 56. 176, 1 , 24 
70 OAT A 141. 4. 192, U1, 2, 192, 76. 29. 3. 234 
80 A LOOK * 975:STAft1 ■ 724 
90 f Off 1 - TO 249 
100 *£A0 arte 
110 P0*£ START * l.BTTC 
120 N€X1 
130 CALL START 
140 RESULTS - PEEt U00l 

150PA31T RESULTS ; fi£N»E$ULTS0FO HEAN NOTAirE;32*eA*5AIlE8uTH0 80 

COtUHMS; 64 MEANS A 1 1 E WIT** 80 COLUMNS 8UT HO AUX MEN; 1 26 ME AJIS Al I € 

160 END 
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Apple lie Identification from Pascal 

Here is the assembly-language identification program previously 
described in the form of a Pascal procedure. 



Apple lie Identification from 
Pascal 



.macro 

pla 

ST* 

PLA 

51* 

,enp* 



POP 

■ 



; 
; 
; 

.MACRO 
PL* 

PL* 

PL* 

PL* 

.ENDM 

* 

i 

r 
i 

tFUNC 
return *eou 

SAFE FflU 
r 

; 



.1+1 



pull. bias 



10.0 

o 

GGG2 



;S*Vt PASCAL RETURN ADDRE55 



ADJUST FOR FJNCTJON 



;T€HP STORAGE OF - * TURN TO PASCAL AOPttSS 
;STAPT OF CODE RELOCATED OH PAGE 2ER0 



NV 



POP 

PULL.*!** 

PhP 

Sf I 

LP* 

LOA 
LD* 

CMP 



LO* 
8Hj 
LOA 
»NI 

LOA 
§Hf 
LOt 
LOU 
LOA 
SIX 
5TA 
DET 



Pf T \}*H 



QCOS* 
0CO49 

-6 

OUT! 

ocotr 

OUT? 

0C013 

0UT4 

0C01A 

OUT* 

*2A 

start-i ,y 

SAFE-l.t 
SAFE-1 # T 
START-1 , Y 



; LOCK OUT INTERRUPTS 

;ENSURE READING ROM BY TURNING Off 
;0Atf«ABLE MEM 

; GE T APPLE I If SI ON MURE NYTE 

; If NOT -6 THEN NOT APPLE lie 

;*** 80 COLUMNS fOUNO DURING STARTUP 

; IF HIGH I IT ON THEN NO «0- COLUMN CARD 

;SEE I F Auk »C*ORY fit 1 NG RE AO 

;AU* HEM BEING USED SO AUX MEN AVAIL 

;SEE IF AUX IP ICING USED 

;AUA 2P BflNG USED SO AUX HEN AVAIL 

;NOT SURE YET SO AE£P CHECKING 

;SUAP SECTION OF IP WITH 

;CODE NEEDING SAFE LOCATION DURING 

;R£AD AU* MEM 
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H 





A ■ E 


** 






i un 


r iff 
J * » c 


f HlUD T t\ tlCC OAlthn 

, JU"r IU 3 * " r. viuuiu 


Alt 

vm 


c w a 




l k ft r i Cftfttt cite £ £) ft 1 1 U ft ci t ri r 




I It ■ 

LDT 


**? A 


;MOVE ZERO PAGE vACH 


w V . 


LDA 


5TA A!T- T ^ T 






a i a 


r if I .4 # 
J ■ r t 1 a T 






















P L 1 

^ W ^ 




i re i ft a r f %*nm 






WV 1 V 


■ r i a ft * <ri <fl fcft liji nam 


mil L 


i n a 


f Olf 


•.yinf * * eft r ucbf it alii Hf H-tf T 






PAR AN 


; Pa H AH - Stlv 




JMP 


OUT 




All I I 


I til 

L 0* 




■ ^ r, r i null it a . l " wn ttiv in c£f 
* KG COLUMNS B J T HO iU» 30 at I 




e r i 
9 ■ * 


B i ■ 1 H 






t HI 


PUT 






1 til 


*>ft 






r ti 
J 1 H 


U 1 V 4 U 






1 HQ 

J Mr 


PillT 
Oul 




T 1 

own 


i ni 
LDA 


*0 


fHoT AN APPLE 11^ 50 5eT PARA^*V 




ST* 


P AH A** 




OUT 


LDA 




;GET PASCAL RACK 




LD* 


OCOfll 






PLP 




;RtACTrVATt IRTEKN0PT5 




ID* 


»0 


;PUT IN HIGH BYTE Of RESULTS 




r t* a 








i hi 


p n * ht" 


> huY * ftjifti ft u A t 1 1 £ f H 4 AU A Y T E ■ E> l! • n 
, rj I * U ill v l"lUf IV kUl E-l II n +*v > ^ 




PH A 








r l\l 


id nib 


■ ELC t^Ul Hi it EtCTllSlb I ft Pi 

;HEaTO*E PAStAL ntTURPI ADO 




PM 








LDA 


RETURN 






P H A 








RT5 






param 


* ITT E 






i 

; ROUTINE RUN 


IN SAFE AREA NOT AFFECTED SV HOVE S 


■ 

START 


LOA 


-DEE 


;TflV STORING . IN Ay X REN 




5TA 


0C005 


; WRITE TO AUX WHILE ON MA IK IP 




5TA 


0C0O3 


;SET TO READ Au* RAM 




5TA 


DflOO 


;CHECC FOR SPARSE MEM MAPPING 




LDA 


OCOO 


; S EE IF SPARSE M£ MOR V - SANE VALUE 




[NP 


'DEE 


; 1 « AWAY 






AulNEft 






A5L 


OCOO 


;NAT BE SPARSE MEM SO CHANGE VALUE 




LP* 


GftQO 


ft SEE WHAT HAPPENS 




CMP 


acoo 






BNE 


All* HEN 






sec 




; SPARSE NAPPING 50*0 AUK MEM 




tcs 


RACK 




AUXNEN 


etc 




; THERE IS AUX MEM 


• AC< 


ST A 


0C004 


;SWITCH 1ACX TO WRITE MAIN RAN 




$M 


OC002 


|SWITtN OAC< MAIN BAM READ 




JNP 


ON 


;C0NT1NUE PROGRAM ON P6 S MAIN NAM 


DONE 


NOP 




; END OF RELOCATED PROGRAM MARKER 




.end 
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Storing Graphics Pages from Applesoft 



Hi-Res Page Mover for Auxiliary 
Memory Demo. Using auxhove 
Subroutine. July 1982 
pa*n - Hi byle ol ibt>*. (Page * 
times 32 ». 

Call putpag io copy M-res graphics 
page lo aux. heh. location specified by 

PABW 

Call 6E1PAG to load hues graphics page 
from aux. men. location specified by 

PAS- 



II is generally not practical to use Ihe auxiliary memory from BASIC 
A BASIC program can only move its variables in memory by getting 
very tricky with peek and poke commands, an approach that is 
both inefficient and dangerous. 

There is one form of data that uses lots of memory and is simple 
enough to handle from Applesoft: high-resolution graphics pages 
The auxiliary memory is an ideal place to store as many as five 
complex graphics pages for rapid loading into Ihe display buffer 

Like all of these examples, the following Applesoft example 
includes two short assembly-language subroutines. The first listing 
is the assembly-language form of the subroutines. The second 
listing is the Applesoft program with the machine-language 
subroutine included as a series of data statements. This method ot 
adding a machine-language subroutine to a BASIC program is not 
very efficient, but it is convenient for short subroutines. 

The program has two phases: in the first, the program generates 
five different high -resolution views and stores them in auxiliary 
memory; in the second, the program loads the stored graphics 
pages back into main memory one after another 





DSCCT 






0*G 


S3C 


S*ti£G 


OS 




fibCCNO 


DS 


z 




Df 


a 


0ES1tE6 


OS 


2 




E> E N D 





PG16EG EQU 52000 

P&TEHO EOU SJFFfi 

AltfMOVE EOU ftCJM 



0*G S300 
» HOVE MI-HES PACE TO AU1 «»: 
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PUTPAG 



EflU 
LDA 
5TA 

LOA 
STA 



PGiBEi 

tnttu 

-iPGlBEG 
StCtEG+1 



;PAGE STARTING 
;ADD*ESS 



LDA 
5TA 
LOA 
5TA 



5NCEN0 
*:PG1END 
SNCEND* 1 



; PAGE ENDING 
; ADD1C55 



DESTINATION *0DBFSS 



lda 

STA 
LDA 
511 



• 

*A*H 

OESTtEG+1 



DESTINATION 
; P AGE a EG INNING 
;ADDM55 



* USE AUIWOVE TO DO IT: 



SEC 
JSN 
tT$ 



AUIHGVE 



* COPT PACE TO «A1N NENOfiV 



GE'PAG 



too 

LDA 
ST A 

LDA 

ST A 



*>PGliEG 
DtSTSEG 
'JPCIftEG 
OESTiCG* ! 



DESTINATION 
;PAGE BEGINNING 
j A0DDES5 



A PA AM ' SOURCE ADDRESSES 



LDA 
ST A 
LDA 
5 T A 



• Q 

SNCIEG 
PAP* 

SRCBEG+1 



;PAftff FON 

fSOUKCE BEGINNING 

;A00ffESS 



LOA 
ST A 

CLC 
LOA 
ADC 
STA 



SNCEND 

PAftM 

•*1f 

SNCIN0--1 



;C0WPUT( S0U*CE 
; END JNG ADDRESS 



USE AuiNOvf TO 00 IT: 



CLC 
JSN 
PTS 



AUlHGVfc 
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Glob*. Hi res grantees demonstration 
lor the Apple He Extended 80 Column 
Teit Card 



99 

100 

10? 

108 

10* 

IU 

Ufl 

119 

*27 

120 

1?9 

ISO 

160 

1?0 

19& 

199 

200 

210 

220 

230 

298 

299 

JOG 

510 

320 

510 

3*0 

998 

999 

1000 

1010 

1020 

1030 

1040 

1998 

1999 

2000 
2029 
2050 
2040 
2050 
2100 
2120 

2990 
2999 
3000 
3100 
3200 
3990 
399V 
4000 
4020 
4040 
4059 
4 060 
4080 
4100 



RE H 
«£* 
REM 

REM 

REM 

REM 

RE* 

RE* 

RCK 

REW 

RE* 

REM 

TEST : 

PRINT 

R£N 

REN 

OATA 

DATA 

OATA 

OATA 

REN 
REN 
PAR* * 



This program d^ew* five ■- * - * * rotating g '. ot r -j T .. h * 

f » v? cooiit of thfHi*Rvip^ge trt iu»il<ir v *ee>ory * 1 1 t hen 

lOrfrft trie * * 0* »vX 1 I 1 »r V M*or» I I c I* into tht hi 

grepM 1 1 i j i f m «iin r * ' , t on# after ano t ner • The * iD 1 d 

lueeei) I on of v »■ - - - - i 1 - ' r - ; * ; ' I ■ I 1 on of * toi t d 
rot Pt i *g 9 lofcf * 



HONE 
CHRS 



<17| : REM CTRl-o for 40-coiu»*n d» tpiey 



subroutines *n eeerUne leigwegec 
169,0,133,60.169,32.13 3,61,169,248.133,62,169,65.133 
63,169.0.133,66,173,0,3,133.67,56,32.17,195,96,0 
169.0.133,66,169,52,135,67,169,0,153,60,173,0,3.133 
61 ,169. 248, 13 3. 62, 24, 173, 0,3,105.31. 133. 63 ,24, 32, 17,1 9* 
,*6 

Read tn* Pager subroutines ar »d store at $301r 
766:PUTP*6E - 769:8Rt«GPA0l - BOO 



FOR r * TO 64 

1 READ BTTC 

: POKE PUTPAGI 



. 6 ■ ~ t 



REN 

REM 



: 



I r * - ng ntr i di mi r I t piei ) ; 



Stt Up * D n *f Rnt 6 

M * 3.14159265eP2 * PI 2 

SP * P2 9: REM i- - - between flerlaiens 

EP - 5P Si REN StflMlng angle increment \ r vifMS 

01 h P ; 15; R(N t*gwtnt ;i it tingle) far li j- ■ j fieMdleni 

8 * 1 : REM Se*H-*e jor H-fl of el t *p*e*. 
REM 

RE* Loop mating *t 2000 dr^t tUe *1t*l ttoret thea: 

FOR V1CU - 1 TO 5 

: REM H&R TO e**5e Vtfy; 

t NGft : HCOLOR- 3 

I REM 0'§tf o ' C I 1 - * 'rent [ 

i HP LOT 60,0 TO 60,159 TO 219,159 TO 219.0 TO 60,0 
E VTA8 23: MTA8 9 

t PRINT ... constructing * I e» * ;VIEW 
; REN 

: DP * EP • v I C u : RE** different M**t*ft» «*> (t»*>. 

: REN Loop * ter t mg *t 3000 : - fief I j f ens (ell psei) : 
E FOR I ANGLE * DP TO PI STEP SP 

::A » COS (I AMU) I Rtf Jt«l»»lnoe e*n of tlUm, 
eeFIRST - 1: RE* for plotting 
REN 

e REN ;oop 1 1 ir 1 1 rrg j ♦ 4000 dri<i e *er I at en (till p*e) 3 
tt FOR THE T A - TO PI STEP 0T 
: : : ifT Jt » * * |1| (TNETA) 
ME LET Y * 8 * COS ( Tfit T A > 

itt REN Kni t«o If AM icite PY end pt for plotting, 
E E E LET Pt * I * 55 * UO 

: : LET Pf • T • 55 * 80 
EEE IF FIRST THEN MP LOT PI ( PTjFlRST - 
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4110 =[[ IF MOT FUST THEN H PLOT TO tt 9 Pf 

" " t : HE1T THETA 

4300 ; »EIT 

4400 : ¥T»I 23; HTAa 9 

4410 t MIM « , .itor tng vie* # ;V]fU 

4499 : B I" 

45 00 . '«[ v ~* \* luX 1 I * »r V 

4510 : PO«E P**N,V1EH * 32 

4520 | CALL ■UTPAGE 

4400 *E*T VIEW 

4689 *EM 

4690 l ttortd" t ■ - |h*m 
4700 HOME t VTAi 23 

4 720 hTA| 3 i PRINT Load i«g v< t*i - - * =■ - * ■ ■ -.i - ■ ■*« * - ■ t ' 

4998 ntn 

4999 *E H Loop » t *r t ing at 5 000 : ' ■ - | ■ vify> from luiUiirf MMf T S 

5000 *0B VIEW - 1 TO 5 
5020 : POKE PARN, i :-- • 32 
5040 : CALL 19 I RfiP AGE 
5060 MX! vuy 

5997 REN 

5991 R(N *•! I H Tf.»* tfltM ' . *-.«r, 

5999 BEN or ur>l I I t"« futt HIqnii 

6000 GOTO 5000 



Storing Data Strings from Pascal 

These Pascal routines use locations scoo to sbfff in the auxiliary 
memory lor storage and retrieval of strings. 

The code that moves the strings to and from auxiliary memory is 
stored at E000 in the Extended 80-Column Text Card. A separate 
initialization routine puts this code at eooo. just once, to maintain 
system performance. 

The retneval routine is very fast, roughly equivalent to a MoveLef t 
from a Packed Array of Char. The storage routine is less 
efficient; if speed is important in your program, you may want to try 
to optimize It 

Uhe !he other examples, these routines were written lor a particular 
application and are not general- purpose subroutines They are included 
here to show you the kind of thing you can do with the auxiliary 
memory 
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Auxiliary Memory String Routines 

by R Ussner 



Tnr o» i ' r Ou t ne »* oer f or aeo on once* The rout l n* » r A*r *U¥e 
at rings * n and out of the Cil ended BO-Col unn f t« t li - : i - aoved in E » -« ' 
in the j j ■ ■ a p aeaor k> * 

.TITLE AS5EHIL* ROUTINES He I N I f I * L 1 1 AT I ON 
- PACE 

.NOMACtOLlST 
.ROPATCHLlST 



RDHA 1 Rtfi .ECU 

R0AU14S . E Li 

URMAIN4* .CQv 

UMUJUB -SOU 

RVNAIN16 iEOU 

RUALU16 .€QU 

hireso* r .toy 

; 

3 

RETURNO .equ 

RETURN! -EQU 

; 

; REGISTER »AP 

J 

ZM f GOO ,EQV 

;»£G0? .tOtl 

ZPEG04 .EOU 



OUT* 



s r a 

IDV 

OUT4NE0 LDA 

ST A 

0£i 
SHE 

LOT 

OUUNE1 LDA 

5TA 
DET 
IMC 
S T A 
ST A 

; END OF THIS ROUTINE 



OCOO* 
0C0D3 
0C0D4 
0C00S 
OCOOB 
0C009 
0C056 



028 
fl?A 



; SOFT SWITCHES* SEE 
; He REFERENCE NANuAl 




I 
6 

RWAUX16 

-80. 

E0G25TUF-1 j T 
0E0D1 t y 

OU?4«E0 
-OFF 

ElOaSTuF-l ,T 
0E101 ,Y 

0UT4KE1 

RVttAIJMft 

HIRESOFF 



; WRITE AUK NEMORT 
; LENGTH OF PATCH 



; LEHGTt* OF PATCH 

;C0Dt NlEMNG SAFE LOCATION 



; WRITE HAIR HEHOR? 

; NA<E h I RES P - AVAILABLE 



Pur poie ; Povet a it r *ng " aa iu> » 1 i *r ■ niio^v to Pate a I - 



If the propria * ■ ■ l i ■ e Eitended 
following code Is moved to EDO?. 



l-tolunn Tf-i Card, t He 



The program get* ittrt fro* a JSR it POVE-FR.AUA. and go** bach 10 
that t fr* aui 1 1 i*r> nior^ cart be turned bach off. Zerq page on t ne 
attended te*c n j - ZREGO0 and ZREG02; they are tna 

arguaent * for tfta no^t. Stack uS4QV : The rftyrrr addra*« tn 48* aai n 
aaaor r la * t or ed m tha j - i \ 1 1 er * stack * This if the only u«a of the 
aut i L lory »e*ory ttac*. 
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i 
J 

EOOiSTuf CLD 

ST* R0AU*A3 

101 *0 

LOA (2REC0O),T 

; USING AUX 2EAO PAGE 

STA (*RE«02),y 
BEG. E002EX1T 
TA* 

E002LOOP LDA <£«EG00> , T 

STA <Z*EGQ2),Y 
DEf 

■ HE EQ02 LOOP 

EM2EXIT STA ROtfAJNtS 
RTS 



J READ AUK 

; «EADI*1» Aul IBC 

; WRITING IAIN 4fl< 

j NOT LI«U ( BUT POSSIBLE 



; READ MAIM «R 

; GOING BAC* TO *B< RAN 



f 

r 

; 
; 
; 
; 



■ . - > ■ Rovei « ttring fro* Pascal to mil tlirv nesiory . 

14 the progr«« findv Ifr* Ettended SO-Coluam Te»f : »■ 2, the 
hi 10k^9 code 1ft noved to £102. 

Tne Drcgrati get s nere f rois a JSR tn MOVE. TO. A UX, and goes bach 10 
that iKt auiiiiarv Mior/ can be turned bat* off. Zero peg* on. t he 
• 'tended ie*t card con: ai n* 2 RE GOO and Z BE GO 2 e»aci I y as t h ev ire 
found on ine Me*r> iero 

Stack usages The return address *n *G* ma i n »ee>ory i * i tortd in the 
auxi liarv it eel This < s the oni y use o* the imUiiry v 
ttacK. 

note at to that rha auxiliary ftro paoe ta uied for the to and f ro« 
addresses . 

ZREGO0: Address o* string that *ants to be stortd 

ZREGO? : Address of integer t nef »ant s t a kno* uhtre it *at stored. 



or rgcei ve * 



no r o O m 



ZREGO*: Used to i*de* on receiving address 



NEXTAVA1 
E1Q2STUF 



.EOU 0E102 

.WORO 0C00 
CLO 

; X r $f MEANS RESET fiAC* TO B EG 1 RR1 NG < DOME FOR EACH RE* Hit 

LOT -0 

IDA <ZB(G00} f Y 

CNP #0FF 

BNE E102C0 

LOA -0 

STA ME * T A VA I + 1 

LOA *0 

STA MEITAVAI 

SCO €102* All 
CORTIMUE WITH MOR»AL ROUTINES 

LOA MEITAVAI*! 

CHP #0BF 

&N£ E102C1 



EI02C0 



; RESET TO SCOO 



; UNCONDITIONAL 



; CHfCK FOR FULL 
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SPACE IS FULL , SO RE TURK Zt«Q 





LDA 




-0 








TAV 












STA 




fZREC0J>« Y 


# 


RETURN A 2£RO» FULL 




INY 












5 T A 




f ZRE602) i Y 








MI 




E 1 02 FA 1 L 




UNCONDITIONAL 


; THERE IS 


STILL NOON, SO CONTINUE 








LD Y 




'1 








STA 




( ZRE G02 ) a Y 


* 


STORE IN RETURN AODR 




STA 




Z*E604+t 


* 


SETUP THE NOVE 




OEY 












L&A 




MEM T A V A 1 








STA 




( ZPEG02 j t y 


* 
• 


LOW I YTE OF RETURN 




5TA 




ZH E 604 




MORE OF THE HOVE 


; NOW IRCREHENT TH| 


NE<T AVAILABLE ADDRESS 








CLE 












AOC 






* 


AOO 1 FOR STRING LENGTH 




%Hi 




*+s 








IRC 




NEXTAVAI f t 


• 
■ 


ROLLED INTO NEKT PAGE 




tLC 












LDT 




*0 








AOC 




i ZREGQQ ) , Y 


i 


AOO LENGTH OF STRING 




STA 




NEXTAVAI 


■ 


PUT IT 1ACK 




act 




• ♦S 








inc 




NEITAVAI+1 


• 


INTO WE 1 T PAGE 




STA 




URAUA46 




WRITING INTO AU* 4** 




LOA 




(2REG00) , Y 


• 
■ 


READING AU* 4&ft 


■ 


USING AUX ZERO PACE 








STA 








WRITING MAIN ilK 




0EQ 




M02IKIT 








TAV 










El 02 LOOP 


LOA 




UREGGO) , Y 








STA 




(ZREG04) ,Y 








OEY 












BNE 




E 1 02LQQP 






£102fXIT 


STA 




URMAIN4& 


> 




E102FAJL 


RTS 








GOING SAC* TO 4B* RAH 




■ END 










; The *oMo»>ng coot 1* 


L Ihktd into t h« t 


n 


P#*c«t program. Thift l« 


; s t or ts t \ - i ■ : i 1 - ' In t h* i H : r - . o*ge j J ■ ' r* ■ u*ps to £* • * 


; tK* E-t#nded AO - 


Cot umn Tt ■ t C*r<l. 








-TITLE 


A5Se«»Lt ROUTINES FOR Mf 


■ 




.PAGE 












« NONA £ ft Of. J 5 T 










. NOPAT CHL t ST 








RDM A I N4l 


.EQU 




0C002 






RDAU14& 


.EQU 




0C00* 






*MAIN46 


.EQU 




0C004 






HRAUK4B 


-EOU 




0(005 






RtfAU*16 


■ EQU 




0C009 






RUHAINU 


,EQU 




OCOOfi 






; RETURN ADDRESS ZERO PAGE LOC At 1 0N£ 






* 

RETURnO 


■ EQU 




026 






RETURN! 


i EQU 




0?A 
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; REGISTER MP 

■ 

* 

ZPEGOG i EQU 

zpeggz .equ * 



* TITLE HOVE STlt IHGS FROH II* AUXHJMV HENOR* 

. PROC HOVEFAAU,2 



PROCEDURE HOVE-FP-AUX < FPiQUA ; VAR T0A> <* Hove ItHng *> 



* 0urr * • ft ring fro* j ■ M |ry *t«or v to P«*C*l • Ho 41 0* tit 

♦ IC tuBl RO¥t i-B donf ft |ur>Liir^ ntmar* I o : • i 'on E002* 

; 

; Star* usage: f^put, output ttfoveises. 

; 

3 STORE RETURN ADDK IN AUX ZERO PAGE 

POP RETURNO ; RETURN TO PASCAL 

j ADDRESSES ARE TWO I V T El , PULL BOTH BtTES Of F THE MAIN STACK, THEN SM|1C" 
t TO AUX ZERO PAGE *ND STORE BOT- BvTEt. 

PL* 

TAX 

PLA 

STA RtfAUXl* ; SWITCH TO AUX ZP 

STX IREGQ2 ; IN AUI ZERO PAGE 

ST A IREGOZ+1 ; STILL IK AUX HE* 

ST* RWHAlttle ; SttlTCr> to hau Z* 

; STORE FROM ADDRESS IN AUI ZERO PAGE 
PLA 
TAX 
9 LA 

STA RWAUXId [ SWITCH TO AuX ZP 

ST* ?R£QOO ; IN AUX ZERO PAGE 

STA ZftfGOO+1 ; STILL IN AUX HEX 

; NOW HE I OVER TO AUK PAGE ADD 00 IT ALL 
j£R OEOO? 

; HON PROCESS COKING SAC* F#0* ED&2 IN AUX MEMORY 

STA RVM1N16 ; HA IN IP AND TOP 

PUSH RETUffNO 

RTS ; BACK TO PASCAL 



•TITtE HOVE STRINGS TO JlR AUXILIARY NEHOBT 

,PROC Hov#ToAu.2 

PROCEDURE HOVE, TO. AUX ( VAR FRONA* VAR tOA) (• *0¥» ttnng * J 



Purooi*: HO»E B PBSC*( »tring to #U»i I i»ry «*NOrp . Most 0* th? 
ictuit «ovt it done At Auiiltarr nfcuofw Location E10?. 

5 1 b c * usage: Incut* output Jddr«**ei, 



STORE RETURN ADDS IN AUX ZERO PAGE 

POP RE T uRNO ; MAIN ZP STAC* 
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< NOW STQRf TO AOOflESS IN *UI JfRO PAGE 



PLA ; LS3 OF AOOR 10 REluM 

TAX 

PLA ; KS8 OF ADO* TO RETURN 

5T A RWAUK16 ; SWITCH TO AUX ZP 

STX 2REG02 | JN AUX : — ■ PAGE 

sta jregos+i ; stul i« aux her 

STA RWNA I Nl 6 ; SWITCH TO t»AI« IP 

; STORE fRO* ADDRESS IK AUA ^ERO PAGE 

PL. A ; L SB OF INPUT STRING 

TAI 

PLA 

STA RWAUX16 ; SWITCH TO AUK *P 

5 T X JRE6O0 ; IN AUX 2CR0 PAGE 

STA 2REG00*t ; STILL IN AUX Hin 

; now get over to aux page and do 11 all 

j5r 0e1d4 ; jump over next ava i a1 £102 

; re turn fron ei<k jn aux mmorv 

sta rwhaint6 j hair to ha in 2p and top 

pu5h re twrno 

RTS 



. E HO 



Programming Examples 



Index 



Index 



A 

accumulator 30, 31 
address bus 7 
address 30 
data 29 

destination starting 30 

program starting 31 

source starting 30 

source ending. 30 

transfer 31 
alternate zero page 25 
ALTZP soft switch 25 

figure 27 

table 26 

warning 29 
Annunciator 3 11 

display page used 12 
Apple II 35, 36 

compatibility 25 

system software 15 
Apple II Plus 35. 36 

compatibility 25 
Apple He viii ( 7, 35 

control keys 4 

display memory 18 

display modes 4 

display pages 16 

double high-resoiution 
graphics 11-12 

escape sequences 4 

identification from assembly 
language 37 

identification from BASIC 40 

identification from Pascal 41 

Installing card in 3 

processor 4 

Rev A 12 

Rev B 11 
Apple Me Identification 

Program 38-39 
Apple lie Identification Program 

(Pascal) 4142 

Index 



Applesoft BASIC 17, 35 
program example using 

AUXM0VE 44 

using to store graphics 
pages 43 
application programs vlli, 21. 
35 

running wilh the card vii 
assembly language 35, 37 
subroutines 15. 37, 43 
programs to use auxiliary 

memory 29 
routine for Pascal 41 

AUX. CONNECTOR 3 

See also auxiliary slot 
auxiliary memory viii. 4, 7 f 9, 
10, 11, 12. 15, 16. 18, 19, 21, 
22, 25, 29, 31, 36, 37 
accessing 4 
address bus 9 
addressing 7 
amount 3 

careless switching 4 
how it works 7-12 
select switches, table 26 
subroutines 29-31 
switching to from bank- 
switched memory 9 
transferring control to 30*31 
using viii 

using from a program, 
examples, 35-51 

warning 9, 15 
Auxiliary Memory String 

Routines 47*51 
auxiliary RAM 15 
auxiliary slot 11 

AUX. CONNECTOR 3 

auxhove subroutine 15. 29, 30 
example using (Applesoft) 44 
parameters 30 
warning 29 



53 



B 



D 



bandwidth, video monitor 11 
bank switches 9 
bank-switched memory 9. 25, 
36 

warning 9 

with auxiliary memory 9 
BASIC 15, 37, 40. 43 

Applesoft 17 

integer 17 

reading soft switches 
from 17 

warning using 15 
bit 29 
bit 7 17 
bit 

carry 29, 31 

color-select 19 

high-order 19, 22, 25 

overflow 31 

sign 17, 22, 25 
built-in 80-column display 

routines 16 
built-in I/O routines 21 
built-in subroutines 29, 30 
bus 

address 7 

data 7 
byte 

high-order 30, 31 
low-order 30. 31 

C 

call statement 15, 40 
carry bit 29, 30, 31 
circuitry, display 18 
CLC instruction 29, 30 
clock cycle 9 

with 80-column display 
on 10 
CLV instruction 31 
color monitor, RGB 10, 11 
color-select bit 19 
commands 

PEEK 17, 43 

POKE 17, 43 
computer configuration, 

identifying 35-37 
configuration 35 
configuration of the 

computer 35-37 
control keys 4 
control switches 22 



data addresses 29 
data bus 7, 11 
data, moving 29 
DATA statements 40, 43 
data strings 46 
decimal 17 
destination starting 

address 30 
display buffer 43 
display circuitry 18 
display cycle 9 
display data 10, 21 
display modes 4 
display pages 16 

control switches 22 

length 9 

locations, table 16 

See also graphics pages 
display soft switches, table 18 
display. 80-column 19 

figure 20 
DOS 3.3 viii, 15. 21 
dot patterns 10 
double high-resolution graphics 

(560 dot) 11-12, 19 

obtaining 11 

board necessary for 12 

with Rev A Apple lie 12 

E 

80-column card, any 36 
80-column display 10, 11, 16, 
19, 36 

addressing directly 18 

bandwidth needed 10 

firmware 3, 4, 36 

figure 20 

map 10 

storing data 9 

switch lor 11 

with clock cycles 9 

versus 40-column display (dot 
patterns) 10 
80C0L soft switch 18 
80-Column Text Card 4. 16, 35, 

36 

80-column text 11, 12. 19 

mode 12 
80STORE soft switch 18, 19. 22 

figure 23. 24. 28 

table 26 

warning 21 
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escape sequences 4 
expansion slot 3 36 

Extended 80-Column Text 
Card 11. 35. 46 
buMer 10 
connecting pins 11 
differences from 80<Column 

Text Card viii 
storing data directly 19 

F 

firmware. 80-column display 3, 
4. 36 

560-dot graphics 11. 12, 16 
See also 280-dot graphics 

40-column texl 11 
mode 16 

48K bank, switching 21-22 
48K memory space 9, 21 
14MHz 10, 11 
functions 

keyboard 17. 25 

Pascal 15 

G 

Globe 45-46 

graphics mode, double high- 
resolution 12. 19 

graphics Page IX (high- 
resolution) 19 

graphics pages 43 
storing from Applesoft 43 
See also display pages 

graphics 
280-dot 16 
560-dot 12. 16 
double-high-resolution 19 
double-high-resolution 

memory mappping 19 
high-resolution. Page 1 19, 
22 

high-resolution. Page 1X 19 
high-resolution program 
example 45-46 

H 

hexadecimal 16, 17 
high-level languages 15 
high-order bit 17. 19, 22, 25 
high-order byte 30, 31 
high-resolution graphics 1 1 , 
36. 43 

Page 1 12, 19, 22 
Page 1X 19 



pages 43 

program example 45-46 

switch for 11 
hires soft switch 18. 19, 22 

figure 24. 28 

table 26 

warning 21 
horizontal resolution 11 



identification return codes, 

table 35 
identification routine 35, 40 

outline 36-37 

warning 37 
Identification, Apple lie 

(assembly language) 37 
identification, Apple lie from 

BASIC 40 
Installation 3 
Instruction 

CLE 29. 30 

CLV 31 

JSR 37 

jump 31 

SEC 29. 30 
Integer BASIC 17 
interpreter, warning using 15 
interrupts 36, 37 
UO 7 

links, standard 21 

routines, built-in 21 

subroutines 29 

J 

JSR instruction 37 

jump instruction 31 

jump to subroutine (JSR) 37 

K 

keyboard functions 17, 25 

L 

low bandwidth monitor 19 
low-order byte 30, 31 
low-resolution graphics 11, 16 

M 

machine language 17 

programs 17 
main logic board 

buffer 10 

Rev A 12 

Rev B 11 



Index 



main memory v!H. 7 t 9. 10, 12, 

15, 16, 18, 19. 21, 25. 31 

address bus 9 

switching 4 
memory 

amount card contains vill 

auxiliary 15 
select switches, table 26 

bank-switched 25 

reading 21. 25 

writing 21, 22, 25 
memory locations 17 
Memory Management Unit 7 
memory map 9, 12, 19 

diagram 8 
memory pages. length 9 
memory switching 15 
mixed graphics modes 11 
hixeo soft switch 18 
MMU 7 

modes, mixed graphics 11 
Molex-type pins 11 
Monitor program 19 
monitor, low bandwidth 19 
monochrome monitor 11 
moving data 29 

N 

negative decimal 17 

o 

operation 
read 17, 25 

warning with 17 
write 17, 25 
warning with 17 
overflow bit 31 

P 

Page 1 
display 19 
graphics 22 

high-resolution graphics 12. 
19 

text 16, 18. 22 
page one 9 

warning 29 
Page IX 

display 16, 16. 19 

high-resolution graphics 19 

text 16 
pages, high-resolution 

graphics 43 
Page 2, text 16 



PAGE2 soft switch 18, 19. 22 

figure 28 

table 26 

warning 21 
page zero 9, 29. 30. 31 

warning 29 
parameters 30 
Pascal 30. 35, 37. 41 

1.1 Vili t 15 

functions 15 

procedures 15, 30 

routines, programming 
examples 47-51 

storing data strings from 46 

warning using 15 
PEEK 17. 40, 43 
PORE 43. 17 
power-on light 3 
procedures, Pascal 15. 30 
procedures, assembly- 

language 29 
processor 4 

processor status word 29. 31 
program starting address 31 
program 
Apple lie identification 38-39 
Apple lie identification 

(Pascal) 41-42 
Applesoft example using 

AUXMOVE 44 

assembly-language 29 

machine-language 17 

Monitor 19 
programmable memory. 

amount 4 
programming examples 35-51 

R 

RAM 4, 7 
amount 3 

auxiliary memory 15 
RAMRD soft switch 21, 22 

figure 23, 24 

table 26 
RAMWftT soft switch 21, 22 

figure 23, 24 

table 26 
read operation 17, 25 

warning 17 
reading memory 21, 25 
registers, X and Y 30 
Rev A Apple lie 12 
Rev A main logic board, 

warning 12 
Rev B main logic board 11 
RGB color monitor 10, 11 
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ROM 7, 21 

routine. Identification 35, 40 

outline 36-37 
routines, builWn 30 

s 

SEC instruction 29, 30 
7MHz 10 
sign bit 17, 22, 25 
6502 microprocessor 7 
6502 stack 9 
warning 29 
slot 3 36 

soil switches 7, 11, 15, 16. 17, 
29, 31, 37 

accommodating 25 
JUTZP 25 

figure 27 

table 26 

warning 29 
Annunciator 3 1 1 
80COL 18 
8QST0RE 18, 19. 22 

warning 21 

figure 23, 24, 28 

table 26 
HIRES 18, 19, 22 

warning 21 

figure 24, 28 

table 26 
MIXED 18 
PAGE2 18, 19. 22 

figure 28 

table 26 

warning 21 
RAHRD 21, 22 

figure 23, 24 

table 26 

RAHWRT 21. 22 

figure 23, 24 
table 26 

setting 15-31 

TEXT 18 

warning 17, 21 
software, Apple II system 15 
source ending address 30 
source starting address 30 
sparse memory mapping 36 
stack 25, 31 

warning when switching 15 
stack pointer, warning 31 
standard I/O links 21 
string routines, Pascal 

examples 47-51 
subroutine call 31 



subroutines 
assembly-language 15, 37. 
43 

auxiliary-memory 15. 29-31 
AUXM0VE 15, 29. 30 

parameters 30 

warning 29 
built-in 29 
I/O 29 
XFER 15. 29 

parameters 31 

warning 31 
switch locations 17. 21 
decimal 17 
hexadecimal 17 
negative decimal 17 
switches, control 
48K bank 22 
display-page 22 
system software for the 
Apple II 15 

7" 

television set 10, 19 

text display. 80-column 12. 19 

figure 20 
text Page 1 9. 16, 18. 22 
text Page IX 16 
text Page 2 16 
TEXT soft switch 18 
transfer address 31 
280-dot graphics 11, 16 

See also 560-dot graphics 

V 

video display page locations. 

table 16 
video displays 16 
video monitor 10 
video display generation 11 

w 

write operation 17, 25 

warning 17 
writing memory 21 t 25 

x 

X and Y registers 30 
XFER subroutine 15, 29. 30 

parameters 31 

warning 31 

z 

zero page 25, 29. 36, 37 
warning when switching 15 



Index 
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Schematic Diagram 
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i 
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